home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat6 / bgpaste.z / bgpaste
Text File  |  1998-10-30  |  4KB  |  67 lines

  1.  
  2.  
  3.  
  4. BBBBGGGGPPPPAAAASSSSTTTTEEEE((((6666DDDD))))                                                        BBBBGGGGPPPPAAAASSSSTTTTEEEE((((6666DDDD))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bgpaste - paste an image onto the root window
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      bbbbggggppppaaaasssstttteeee [[[[----tttt rrrr gggg bbbb]]]] [[[[----oooo xxxxoooorrrriiiigggg yyyyoooorrrriiiigggg]]]] iiiinnnniiiimmmmaaaaggggeeee
  13.      bbbbggggppppaaaasssstttteeee [[[[----tttt rrrr gggg bbbb]]]] ----nnnn nnnnuuuummmmiiiimmmmggggssss xxxxoooorrrrgggg yyyyoooorrrrgggg iiiimmmmgggg [[[[xxxxoooorrrrgggg yyyyoooorrrrgggg iiiimmmmgggg .... .... .... ]]]]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _b_g_p_a_s_t_e works in one of two distinct ways:  either feed it one image,
  17.      which by default is automatically centered (or explicitly specify the
  18.      image's origin), or feed it a list of one or more images preceeded by
  19.      their respective x/y origins to be painted as a composite in the root
  20.      window.
  21.  
  22.      In the first case, _b_g_p_a_s_t_e centers and pastes inimage onto the root
  23.      window regardless of inimage's size.
  24.  
  25.      You can override the "centering" default and explicitly position your own
  26.      image manually by using the -_o option to specify the image's absolute-
  27.      screenspace origin as measured from the bottom-left corner of the
  28.      graphics display screen.  The _x_o_r_i_g,_y_o_r_i_g pair is defined in terms of the
  29.      image's bottom-left corner.  Negative values are legal to specify and
  30.      will "plant" the image's origin offscreen to the left and/or the bottom
  31.      of the screen origin.
  32.  
  33.      In the second case, the -_n flag tells _b_g_p_a_s_t_e you are including a list of
  34.      _n images, where each image is preceeded by its respective x/y origin pair
  35.      (again, negative values are legal).  The intersection of the composite
  36.      set of images with that of the root window size is calculated and a
  37.      buffer of that size is allocated which will contain the composite.  The
  38.      images will be painted in the order enumerated:  the first image listed
  39.      will be painted first, the last will be painted last.  Any "background"
  40.      within the composite, as well as any remaining area of the root window
  41.      not included in the intersection, will be painted with the default gray
  42.      color or one defined using the -_t flag.
  43.  
  44.      In either of the above descriptions, if either the X or the Y size (or
  45.      both) of inimage/composite is smaller than the screen size, a gray
  46.      background is painted where the image/composite doesn't appear.  This
  47.      gray default color can be redefined to be a specific RGB triplet using
  48.      the -_t option followed by the _r _g _b integer triplet.  Use izoom(6D) if
  49.      you wish to blowup an inmage that is smaller than the screen's X and/or Y
  50.      size.
  51.  
  52. NNNNOOOOTTTTEEEE
  53.      When employing _b_g_p_a_s_t_e -_n performance will degrade because of the
  54.      creation of the buffer which stores the composite root window image.
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      izoom(6D)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.